home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / sfcb13.zip / INSTALL.INF / SFCB.DOC < prev    next >
Text File  |  1993-04-19  |  63KB  |  1,302 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                          tm                    SFCB 1.3 █▌
  10.                                  SPITFIRE  Call-Back Validation Utility ▐
  11.                              The ORIGINAL call-back door for SF systems ▐
  12.                                                  Copyright (C) MCMXCIII ▐
  13.                                                        Richard Sleegers ▐
  14.                                                       RainbowSoft Wares █▌
  15.  
  16.  
  17.                                               Released:  April 19, 1993
  18.  
  19.  
  20.  
  21.  
  22.                                                                  Page 1
  23.                    SFCB [Spitfire Call-Back] Documentation
  24.  
  25.       ▄──────────────────────────▄
  26.       │    TABLE OF CONTENTS     │
  27.       ▀══──────────────────────══▀
  28.  
  29.       TABLE OF CONTENTS . . . . . . . . . . . . . . . . . . . . . .   1
  30.       INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   2
  31.       IN THE BEGINNING  . . . . . . . . . . . . . . . . . . . . . .   2
  32.       INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .   3
  33.            Automatic Installation Program (RSWINST.EXE) . . . . . .   3
  34.            Manual Installation  . . . . . . . . . . . . . . . . . .   4
  35.            Running SFCB as a DOOR . . . . . . . . . . . . . . . . .   4
  36.            Running SFCB from the Main Menu  . . . . . . . . . . . .   4
  37.            Running SFCB during initial login automatically  . . . .   5
  38.            Configuring SFCB . . . . . . . . . . . . . . . . . . . .   5
  39.       COMMAND LINE PARAMETERS . . . . . . . . . . . . . . . . . . .   6
  40.       CONFIGURABLE OPTIONS  . . . . . . . . . . . . . . . . . . . .   7
  41.       FEATURES  . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  42.            SUPPORT FILES  . . . . . . . . . . . . . . . . . . . .    10
  43.            SFCB.INI . . . . . . . . . . . . . . . . . . . . . . .    10
  44.            SFCB.OK  [PreValidated]  . . . . . . . . . . . . . . .    10
  45.            SFCB.BAD  [DoNotValidate]  . . . . . . . . . . . . . .    10
  46.            SFCB.XCH  [LocalExchanges] . . . . . . . . . . . . . .    11
  47.            Log Files  . . . . . . . . . . . . . . . . . . . . . .    12
  48.            SFCB.VAL . . . . . . . . . . . . . . . . . . . . . . .    12
  49.            SFCB.NVL . . . . . . . . . . . . . . . . . . . . . . .    12
  50.            SFCB.LOG . . . . . . . . . . . . . . . . . . . . . . .    12
  51.            Display Files  . . . . . . . . . . . . . . . . . . . .    12
  52.       EXECUTION . . . . . . . . . . . . . . . . . . . . . . . . .    14
  53.       FUNCTION KEYS . . . . . . . . . . . . . . . . . . . . . . .    15
  54.       WARNINGS  . . . . . . . . . . . . . . . . . . . . . . . . .    16
  55.       DISCLAIMER  . . . . . . . . . . . . . . . . . . . . . . . .    16
  56.       SHAREWARE INFORMATION . . . . . . . . . . . . . . . . . . .    17
  57.       SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . .    17
  58.       TRADEMARKS, COPYRIGHTS  . . . . . . . . . . . . . . . . . .    18
  59.       SFCB HALL OF FAME!  . . . . . . . . . . . . . . . . . . . .    18
  60.       FUTURE MODIFICATIONS  . . . . . . . . . . . . . . . . . . .    19
  61.       MODIFICATION HISTORY  . . . . . . . . . . . . . . . . . . .    19
  62.       QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . .    19
  63.       OTHER RSW PRODUCTS  . . . . . . . . . . . . . . . . . . . .    22
  64.       Quick Index . . . . . . . . . . . . . . . . . . . . . . . .    23
  65.  
  66.  
  67.  
  68.                                                                   Page 2
  69.                     SFCB [Spitfire Call-Back] Documentation
  70.  
  71.       ▄──────────────────────────▄
  72.       │      INTRODUCTION        │
  73.       ▀══──────────────────────══▀
  74.  
  75.            If you are like me, you find it a time-consuming task to
  76.       validate new users.  In order to prevent abuse, you expect that
  77.       your users provide accurate and truthful information; a name and
  78.       phone number to start.  This is a way to contact them in case of
  79.       a problem, or to help, or simply to verify that they are using
  80.       only one account.  Now, doing this by voice may have a personal
  81.       touch, and you can still do this for legitimate first-time users.
  82.       But, it becomes a chore when the numbers turn out to be invalid
  83.       or incorrect and you are getting the run-around.  SFCB is the
  84.       next best thing to putting a telephone operator at your disposal!
  85.  
  86.            SFCB allows a user to validate him/herself by entering a
  87.       door or menu option.  The program will call back, using the
  88.       number provided through the new user log-on.  Upon successful
  89.       re-connection and data verification (name, password and
  90.       optionally, the birth-date or additional password), the user's
  91.       security level will be upgraded to that of your BBS's regular
  92.       user status (selectable by the sysop.)
  93.  
  94.            Other features of the program will be explained in this
  95.       document, as well as some of the necessary Shareware information
  96.       and disclaimers.  I chose to put them at the END of the document,
  97.       so you can worry about the guidelines once you have tried out
  98.       this program and found it useful.  (Which no doubt, you will!)
  99.       Quickly, though, here are some of the important restrictions:
  100.  
  101.       ■    SFCB is distributed as Shareware, you may try it out for a
  102.            period of 28 days, after which time you must register it or
  103.            remove it from your system.  (You may keep archival copies
  104.            of the program in its original distribution package)
  105.       ■    There are no warranties or guarantees with SFCB.  While
  106.            being tested error free on numerous systems, the variations
  107.            of hardware and software can have unpredictable results.
  108.       ■    You may distribute SFCB, on the condition that you do not
  109.            alter the package, or any of the file contents, or receive
  110.            financial compensation for it, other than regular BBS fees.
  111.       ■    For more information, please refer to the sections entitled
  112.            DISCLAIMER and SHAREWARE INFORMATION.
  113.  
  114.            Now, let's explore the origin and features of SFCB!
  115.  
  116.  
  117.       ▄──────────────────────────▄
  118.       │     IN THE BEGINNING     │
  119.       ▀══──────────────────────══▀
  120.  
  121.            SPITFIRE was born under the direction of Mike Woltz, of
  122.       Buffalo Creek Software, to fill a unique position in the world of
  123.  
  124.  
  125.  
  126.                                                                  Page 3
  127.                    SFCB [Spitfire Call-Back] Documentation
  128.  
  129.       Bulletin Boards.  Many users and potential sysops (myself
  130.       included) were drawn to the software for the same reason Mr.
  131.       Woltz wrote it; its simplicity and ease of use, packed with
  132.       features.  Of course, we all have our own ideas for making it
  133.       better and enhancing it, and I hope you will appreciate mine.
  134.  
  135.            This version of SFCB has includes features specific to
  136.       version 3.2 and 3.3 of Spitfire, but it is backwards compatible
  137.       with all versions between 2.8 and 3.1.  It is my intention to
  138.       update the program for future versions at no or low cost to
  139.       registered users (for most, the long distance telephone calls to
  140.       obtain it via modem).
  141.  
  142.  
  143.       ▄──────────────────────────▄
  144.       │       INSTALLATION       │
  145.       ▀══──────────────────────══▀
  146.  
  147.            SFCB comes with an install program which will work for first
  148.       time installation as well as updates from previous versions.
  149.       (You will need about 700K free disk space and 400K free RAM
  150.       memory to run install automatically.  Exit SPITFIRE completely
  151.       (press F10) and install from DOS; then your menus will also be
  152.       updated properly when installing for the first time.
  153.            Extract the SFCB compressed file (SFCBxx.ZIP) - where 'xx'
  154.       is the current version - to a temporary directory or your SFCB
  155.       directory and run the install program RSWINST.EXE from the new
  156.       directory.  For example
  157.  
  158.       PKUNZIP SFCB13.ZIP
  159.       RSWINST
  160.  
  161.  
  162.       Automatic Installation Program (RSWINST.EXE)
  163.  
  164.            After running RSWINST, you will be shown any update notices
  165.       and asked what directory to which you wish to extract SFCB.  All
  166.       of the necessary files needed will be installed, whether you are
  167.       upgrading or installing for the first time.  If you are
  168.       upgrading, there are files which you may have already customized
  169.       (your display files)  These files are optional and will not be
  170.       extracted unless you allow it.
  171.  
  172.            If you are installing for the first time, RSWINST will run
  173.       an automatic install program which will examine your system and
  174.       attempt to install SFCB as a Door, Main Menu Extension or
  175.       Security Logon Batch file.  Simply follow the prompts given, and
  176.       supply and paths which are not properly detected.  If you have
  177.       already installed SFCB in SPITFIRE, you do not need to use
  178.       automatic installation.  If SFCB is still not installed properly,
  179.       look at the Manual Installation section below, or the SPITFIRE
  180.       manual for more information.
  181.  
  182.  
  183.  
  184.                                                                  Page 4
  185.                    SFCB [Spitfire Call-Back] Documentation
  186.  
  187.            When finished, run the SFCBINST program to examine any
  188.       features you wish to change before trying out the door.  At any
  189.       time you may press F1 and receive detailed help on current field
  190.       or topic.  You may jump through the help system to explore other
  191.       options at that time.  The more advanced features are explained
  192.       in this document.  Use the TAB and SHIFT-TAB keys (or ENTER) to
  193.       change fields when you are finished editing them.  Control-Enter
  194.       or ESC completes the current entry window and saves changes.
  195.  
  196.  
  197.       Manual Installation
  198.  
  199.            To install SFCB manually, create a directory for SFCB, and
  200.       then move or uncompress all of the support files into this
  201.       directory.  In this example I will use C:\SF\SFCB for the door
  202.       directory.
  203.  
  204.            Running SFCB as a DOOR
  205.  
  206.            Modify your SF.BAT file to include the necessary steps to
  207.       execute the call back program.  In this example, SFCB is
  208.       installed as Door A.
  209.  
  210.       SF.BAT:
  211.            :DOOR_A
  212.                CD C:\SF\SFCB
  213.                SFCB -D C:\SF\SFDOORS.DAT
  214.                CD C:\SF
  215.            GOTO LOOP
  216.  
  217.            Notice you do not need to copy the SFDOORS.DAT (or
  218.       SFMAIN.DAT) file to the SFCB directory.  In fact, doing so causes
  219.       confusion.  The above will properly work on multi-node systems
  220.       automatically, as long as the node directories are set up
  221.       properly.
  222.  
  223.       You will need a corresponding line in the door menu file:
  224.  
  225.       SFDOOR.MNU:
  226.       Call-Back Verification,5
  227.  
  228.            Running SFCB from the Main Menu
  229.  
  230.            If you run SFCB as a main menu extension, a line similar to
  231.       the one following must be present in your menu file:
  232.  
  233.       SFMAIN.MNU:
  234.       V,<V> New User Validation,,10,@
  235.  
  236.  
  237.  
  238.                                                                  Page 5
  239.                    SFCB [Spitfire Call-Back] Documentation
  240.  
  241.       You must then also modify your main menu batch file, similar to
  242.       what is shown below:
  243.  
  244.       SFMAIN.BAT:
  245.       CD C:\SF\SFCB
  246.       SFCB -D C:\SF\SFMAIN.DAT
  247.  
  248.            Running SFCB during initial login automatically
  249.  
  250.            You may run SFCB from a batch file corresponding to a
  251.       security level.  This will force SFCB to load for specific
  252.       security levels before the user is permitted to the main BBS.  In
  253.       the following example, we will use 10 as the new user security
  254.       level, and use C:\SF\SFCB as the SFCB main directory.
  255.  
  256.       SFSEC10.BAT:
  257.       CD C:\SF\SFCB
  258.       SFCB -D C:\SF\SFDOORS.DAT
  259.  
  260.            If the automatic method does not work properly, and you
  261.       cannot get it installed manually, please refer to your SPITFIRE
  262.       manual for more details on installing door programs, or if you
  263.       are running SFCB as a menu extension.
  264.  
  265.  
  266.       Configuring SFCB
  267.  
  268.            Once SFCB is set up in the batch and menu files, you must
  269.       configure SFCB with the SFCBINST.EXE program.  SFCBINST is
  270.       completely menu driven and contains context sensitive help, so
  271.       you can probably leave the manual now and finish installation
  272.       without reading any further!  However, once you have SFCB working
  273.       with SPITFIRE, you will want to investigate the advanced
  274.       features.
  275.  
  276.            To start, you may wish to alter the starting and ending
  277.       security levels you wish accept for validation.  Any number
  278.       falling in this range, inclusive, will be considered unvalidated
  279.       to SFCB.  The ending security is the security level a validated
  280.       user becomes.  Your Spitfire version must be correctly identified
  281.       as you upgrade so that SFCB knows what system you have.
  282.            The BBS area code and location are used to identify long
  283.       distance calls within the BBS' area code.  The long distance
  284.       field is a true/false field which uses T for true and F for
  285.       false.  Therefore, to enable long distance validation, enter a T
  286.       in the "Allow LD callback" field.  When set to true, you may then
  287.       set the low disconnect baud rate.  Any connections lower than
  288.       this baud rate will be disconnected after long distance
  289.       validation.  A "-1" entry means disconnect all calls, "0" means
  290.       do not disconnect any long distance calls.  Local calls will use
  291.       the validations times chart to determine when call-backs can be
  292.       made.  Likewise, long distance calls will use the LD validation
  293.  
  294.  
  295.  
  296.                                                                  Page 6
  297.                    SFCB [Spitfire Call-Back] Documentation
  298.  
  299.       times.  In this manner you can allow toll calls during off-peak
  300.       times.
  301.            When you select the time chart field (by pressing Enter),
  302.       you will be shown an edit screen.  Press F1 for help on editing
  303.       the time chart.  Basically, though, wherever an asterisk, "*" is
  304.       placed, call back attempts may be made.  Each location
  305.       corresponds to a 30 minute time period, starting with midnight to
  306.       12:30 am (00:30)  You may specify different call-back times for
  307.       each day of the week and for days designated as holidays in the
  308.       [Holidays] section of SFCB.INI.  Using the delete key erases the
  309.       asterisk in the box.  Use the arrow keys to move the box.
  310.       Pressing '*' enters an asterisk, and pressing spacebar toggles
  311.       the time period under the box. (* becomes blank, and vice versa)
  312.       Pressing Enter or ESC saves your changes and returns you to the
  313.       Configuration menu.
  314.            See the bottom line of the screen when editing fields for
  315.       specific information on that particular field.  If you require a
  316.       more detailed explanation on some features and options, refer to
  317.       the Features and Configurable Options section below, or the
  318.       extensive on-line help in SFCBINST.EXE
  319.  
  320.  
  321.       ▄──────────────────────────▄
  322.       │ COMMAND LINE PARAMETERS  │
  323.       ▀══──────────────────────══▀
  324.  
  325.            If you wish, you may use the command line options to specify
  326.       where to find the door file, configuration file, or to override
  327.       the comm port or baud rate in special cases.
  328.  
  329.            Here are the available command line parameters:
  330.  
  331.       -D C:\SF\SFDOORS.DAT     Where to find the door file.
  332.       -D C:\SF\SFMAIN.DAT      Use a line similar to this when running
  333.                      SFCB from the main menu extension feature.
  334.                      Versions 2.7 of Spitfire and earlier will not
  335.                      update the security level using SFMAIN.DAT.
  336.       -B 1200        Change the baud rate to 1200.  SFCB automatically
  337.                      uses the baud rate set by SPITFIRE (in the
  338.                      SFDOORS.DAT file).  If you lock your comm port or
  339.                      your modem follows the connection rate, you do not
  340.                      need to use this parameter.  It is mainly used for
  341.                      testing over null modem cables.
  342.       -P 1           Use Comm Port 1.  (See above, SFDOORS.DAT contains
  343.                      the port the user logged in at.)
  344.       @R             Disable opening shareware screen - available to
  345.                      registered users only.
  346.       -C [filename]  Option used in previous versions of SFCB (1.1 and
  347.                      older).  Remove this option from existing batch
  348.                      files.  When updating from previous versions, this
  349.                      file will be converted to the new format and will
  350.                      no longer be used.
  351.  
  352.  
  353.  
  354.                                                                  Page 7
  355.                    SFCB [Spitfire Call-Back] Documentation
  356.  
  357.       -I [filename]  Alternate file name for the SFCB.INI file.  You
  358.                      must specify the complete path of the file if it
  359.                      is not in the current directory of SFCB.EXE
  360.       -G             Enable DEBUG mode.  When activated, you will be
  361.                      shown additional information as the program is
  362.                      run.  (For example baud rate and port information)
  363.       -X             Enable FOSSIL and DESQVIEW checking
  364.  
  365.  
  366.       ▄──────────────────────────▄
  367.       │   CONFIGURABLE OPTIONS   │
  368.       ▀══──────────────────────══▀
  369.  
  370.            Options are modified via the SFCBINST.EXE program.  This
  371.       program should live in the same directory as your SFCB.EXE file.
  372.       The SFCB executable file is stored in compressed format with
  373.       PkLite or LzEXE and SFCBINST will not work with SFCB in
  374.       uncompressed format.
  375.            The options are pretty straight-forward.  Should you need
  376.       more help on an option, move the cursor to the option you on
  377.       which you want help (with the cursor or with your mouse) and
  378.       press F1.  A context sensitive help screen will display detailed
  379.       help on that option.  A few special cases should be commented on,
  380.       and they follow:
  381.  
  382.  
  383.        Sysop Security   This need not be the sysop security (normally 999)
  384.        Level            but can be any level which you wish to have access
  385.                         to the log files.
  386.        (LD) Validation  The method for disabling call-backs to any 1/2
  387.        Times            hour intervals is to place a '*' in the position
  388.                         in the chart where you want to ALLOW call-backs.
  389.                         (The chart starts and 12:00 midnight, so the first
  390.                         '*' would correspond to the time period
  391.                         00:00-00:29:59 or 12:00-12:29am)   You may find
  392.                         this helpful if you are allowing long distance
  393.                         call-backs and you do not wish to have calls
  394.                         during prime time (save those long distance bills
  395.                         for calling other BBS'!)
  396.  
  397.        Low Baud Rate    This feature is used when a long distance call has
  398.                         successfully completed.  If you wish users to be
  399.                         logged off immediately after entering his/her name
  400.                         and password, place a '-1' (minus one) here.  To
  401.                         allow all callers to remain on-line (and run up
  402.                         those LD bills?) place a '0' (zero) here.  Any
  403.                         other number will act as the cutoff point.  If you
  404.                         place 9600 here, than any caller below 9600 baud
  405.                         will be disconnected, and those 9600 and higher
  406.                         will be permitted to remain on-line, at your
  407.                         expense.
  408.  
  409.  
  410.  
  411.                                                                  Page 8
  412.                    SFCB [Spitfire Call-Back] Documentation
  413.  
  414.        BBS Area Code    This number is essential to determining whether a
  415.                         call is long distance or not.  Place the 3 digits
  416.                         of your area code here.  The location of your BBS
  417.                         is used to ask the caller whether a number in the
  418.                         same area code is still long distance.  To make it
  419.                         easier on the users, each time a new exchange code
  420.                         is entered and validated, add it to the
  421.                         [LocalExchange] section of SFCB.INI or to the
  422.                         SFCB.XCH file.  The user will then no longer be
  423.                         prompted if they are long distance when their
  424.                         number is located in the above mentioned places.
  425.  
  426.        Force Birth      When enabled (True) this option will only validate
  427.        Date             the user if he/she also enters their correct birth
  428.                         date along with name and password.  Please note
  429.                         that if you do not have the "Require New User
  430.                         Birth Date" option in the Alt T (Toggles) menu of
  431.                         SPITFIRE set to YES, than this option will not
  432.                         work properly since there will not be an accurate
  433.                         birth date setting for each user.
  434.  
  435.        Allow Duplicate  When disabled (False), SFCB will search the
  436.                         SFUSERS.DAT file for a duplicate of the current
  437.                         user's phone number.  If you also enable the Allow
  438.                         Number Change setting the new number entered will
  439.                         be used in the scan for duplicate phone numbers.
  440.                         To prevent a user from putting a phoney (no pun
  441.                         intended :) number in SPITFIRE and using the real
  442.                         number within SFCB, you should also enable the Top
  443.                         Security function to force SFCB to search SFCB.VAL
  444.                         (which contains all previously validated phone
  445.                         numbers) and disallow duplicate phone numbers.
  446.  
  447.  
  448.       ▄──────────────────────────▄
  449.       │         FEATURES         │
  450.       ▀══──────────────────────══▀
  451.  
  452.            New to version 1.3 of SFCB is the SFCB.INI file.  This file
  453.       can be used to consolidate most of the files used in previous
  454.       versions.  The SFCB.INI file is a file with separate sections
  455.       containing options (which can be TRUE, FALSE, numerical or text)
  456.       Sections are keywords enclosed in square brackets.  For example,
  457.       the [Security] section contains options pertaining to security
  458.       features.  Most features are explained more in detail in the file
  459.       itself under each section, and some features correspond to those
  460.       in the configuration section of the install program.  Use the
  461.       SFCBINST program to change any settings, and modify the SFCB.INI
  462.       file to change whole sections.
  463.  
  464.            Here is the list of sections and their usage.  Where
  465.  
  466.  
  467.  
  468.                                                                 Page 9
  469.                    SFCB [Spitfire Call-Back] Documentation
  470.  
  471.       applicable, the corresponding filename (which were used in SFCB
  472.       prior to 1.3) is shown as well.
  473.  
  474.       [Messages]
  475.            Sysop configurable response prompts.  Most SF codes are
  476.            supported here.  These include: phone number, security,
  477.            name.  See the SF manual for the code numbers and usage.  ^M
  478.            is a special code which means end of line (carriage return)
  479.       [LogFile]
  480.            As with messages, the LogFile sections responses are
  481.            configurable.  These are written to the SFCB.LOG file.
  482.       [Modem]
  483.            Initialization settings, timings for your modem.
  484.       [Node1]
  485.            There are certain options which can be node specific.
  486.            Replacing Node1 with whichever node you wish to set
  487.            differently (for example, [Node3]) you can override the
  488.            default system settings for the following options:
  489.            InitString, ForceBaud.
  490.       [PreValidated]  Filename: SFCB.OK
  491.            This section will contain numbers you wish to validate
  492.            without a call-back.  Please refer to the Support Files
  493.            section for details on the format of this file.
  494.       [DoNotValidate]  Filename: SFCB.BAD
  495.            Put numbers (or wildcard masks) of numbers you want to block
  496.            for call-back validation.  See the SFCB.BAD section below
  497.            for details on the format.  Please refer to the Support
  498.            Files section for details on the format of this file.
  499.       [AllowDuplicate]
  500.            In this section, list phone numbers which may be validated
  501.            regardless of whether it is duplicate or in a wrong format.
  502.       [LocalExchanges]  Filename: SFCB.XCH
  503.            This section which contains the exchanges used to determine
  504.            which calls are local calls.  Please refer to the Support
  505.            Files section for details on the format of this file.
  506.       [Holidays]
  507.            List dates to determine as holidays for purposes of long
  508.            distance rates.
  509.       [Terminals]  Filename: SFCB.TRM
  510.            This section contains the terminal-specific information.
  511.            Please refer to the Support Files section for details on the
  512.            format of this file.
  513.       [Errors]
  514.            When reporting known errors to the screen, this section is
  515.            used.  This section need not be changed as the responses are
  516.            shown to the local display only.
  517.  
  518.            All sections which use phone numbers may use wildcards.  For
  519.       example, 519-555-* or 519-555-????, when used in the
  520.       [DoNotValidate] section will disallow all 555 phone numbers.
  521.       ???-555-* will disable all 555 phone numbers worldwide.  The '*'
  522.       is only valid in the last position.
  523.  
  524.  
  525.  
  526.                                                                 Page 10
  527.                    SFCB [Spitfire Call-Back] Documentation
  528.  
  529.            All response prompts will replace SF display codes with
  530.       their equivalents.  All response prompts may also be replace by a
  531.       filename.  For example, consider the following line in the
  532.       [Messages] section:
  533.       LDTimeLockout=@LDTIMLOK
  534.       SFCB will search the current directory and the display directory
  535.       for files named LDTIMLOK.BBS/CLR and will display the appropriate
  536.       file.  LDTIMLOK.CLR will be displayed if the caller is using ANSI
  537.       color graphics.
  538.            Any line beginning with a semi-colon is ignored.  A semi-
  539.       colon in the middle of the line will also disregard the remainder
  540.       of that line.
  541.  
  542.  
  543.       ▄──────────────────────────▄
  544.       │      SUPPORT FILES       │
  545.       ▀══──────────────────────══▀
  546.  
  547.            There are a few files that SFCB uses in the course of its
  548.       activities.  Some contain phone numbers which are searched for
  549.       duplicate phone numbers or pre-verified users, and others are
  550.       created by SFCB.  They are described below.  All files are in DOS
  551.       text format and any commands are listed once per line.  Please
  552.       see the example files included for more detail.
  553.            If a keyword is listed in square braces: [PreValidated] this
  554.       means that there is a section in SFCB.INI which may be used to
  555.       store the same information.  Refer to the Features section for
  556.       more details on the SFCB.INI file.  In quotes is the
  557.       corresponding option in the [Messages] section of the SFCB.INI
  558.       file which may be displayed.  In upper case are default display
  559.       file names.
  560.  
  561.       Data Files
  562.  
  563.       SFCB.OK  [PreValidated]  "PreValidate"
  564.            Listing of numbers which do NOT need to be called.  This is
  565.            useful for skipping long distance calls, and yet allowing
  566.            validation.  Numbers are expected to be in the regular
  567.            Spitfire format: eg 519-455-4880.  The number is followed by
  568.            an optional password.  If both the phone number and
  569.            passwords match, the user will be validated to the optional
  570.            security level given, and not the default ending security
  571.            level.  If not password is given, a match on number alone is
  572.            sufficient to upgrade access.
  573.            FORMAT:
  574.            ###-###-####,Password,Security
  575.            EXAMPLE:
  576.            519-455-4880,My123Pass,50
  577.  
  578.       SFCB.BAD  [DoNotValidate]  "BadNumber"  NUMNOVAL.BBS/CLR
  579.            These numbers will NOT be called back either, but the
  580.            security level will not be raised to validated access.  The
  581.  
  582.  
  583.  
  584.                                                                 Page 11
  585.                    SFCB [Spitfire Call-Back] Documentation
  586.  
  587.            appropriate message will be displayed; this message should
  588.            explain what the user should do at this point.  You may
  589.            place additional information after the number, such as user
  590.            names.
  591.            FORMAT:
  592.            ###-###-#### ;additional comment
  593.            EXAMPLE:
  594.            911* ; Do not allow attempts to 911 emergency number
  595.  
  596.       SFCB.XCH  [LocalExchanges]
  597.            This contains the local exchanges available from your area
  598.            code.  If you have all of the available local exchanges
  599.            (from your phone book), you can then prevent the prompt for
  600.            long distance callers when the caller is in a local calling
  601.            range.  (You can check the log file for any exchanges you
  602.            have missed, an exchange verified as local will appear
  603.            there.)  If you have numbers outside your area code which
  604.            are local, list them with the area code in front.
  605.            FORMATS:
  606.            ### (3-digit phone code)
  607.            ###-### (3 digit area code, followed by prefix code)
  608.            EXAMPLES:
  609.            455
  610.            519-455
  611.  
  612.       SFCB.TRM  [Terminals]
  613.            This is the customizable terminal file.  It contains the
  614.            menu list and the specific keywords to wait for upon
  615.            reconnection.
  616.            FORMAT: (for SFCB.TRM)
  617.            OptionName,O, ,GENERIC.DAT
  618.            OptionName is the text to be displayed in the menu.  The 'O'
  619.            refers to the character used to select that option.  The
  620.            string to search for follows, (important: use a space if
  621.            there is no special character sequence to wait for) whatever
  622.            is included in between the commas must be sent by the remote
  623.            program for SFCB to operate correctly.  GENERIC.DAT refers
  624.            to any special information needed by the user to correctly
  625.            operate SFCB with his/her terminal program.
  626.            EXAMPLE:
  627.            Mirror,M,Mirror,MIRROR.DAT
  628.            FORMAT: (for [Terminals] section)
  629.            O Option
  630.            ...
  631.            End
  632.            OHelp=help.dat
  633.            OString=text
  634.            List all of the terminals you will support with the
  635.            character used to select them followed by a space and then
  636.            the terminal name.  Be sure not to use the same letter
  637.            twice.  For each option, the letter, followed by "Help="
  638.            will refer to the data file to be displayed when that option
  639.  
  640.  
  641.  
  642.                                                                 Page 12
  643.                    SFCB [Spitfire Call-Back] Documentation
  644.  
  645.            is selected.  The option, followed by "String=" will be used
  646.            to scan for that text (currently, only Mirror needs this
  647.            feature activated)  The "Generic=" option will be used for
  648.            all options/terminals which do not have a corresponding
  649.            file/string associated with it.
  650.  
  651.       Log Files
  652.  
  653.       SFCB.VAL  "DuplicateNumber","ScanValidated"
  654.            As a subset of SFCB.LOG this file contains only those users
  655.            and numbers that were validated.  If the TopSecurity feature
  656.            is enable, this file will be scanned and if a matching
  657.            number is found, it will not be validated, unless it is also
  658.            found in the [AllowDuplicates] section.
  659.  
  660.       SFCB.NVL  "NoQualify","NoSuccess"
  661.            Likewise, this file contains the users and numbers that
  662.            failed validation.
  663.  
  664.       SFCB.LOG
  665.            If Log File Activity is activated, this file will contain
  666.            information on the call-back process for each user,
  667.            including failed attempts, phone number changes (if
  668.            permitted) times, dates, etc.  You may customize what is
  669.            stored to the log file by modifying the strings in the
  670.            [LogFile] section of SFCB.INI
  671.  
  672.       SFCB.LST
  673.            Used to save information from the last caller who used SFCB
  674.            so he/she is not required to re-set the options and can try
  675.            again immediately.  If another user uses SFCB in between,
  676.            this file will not be used.  It may be safely removed at any
  677.            time.
  678.  
  679.       SFCB.RCT
  680.            If Log Reconnect is activated, then any incoming data right
  681.            after connect is logged to this file, up until the time of
  682.            the Reconnect timeout value.  This will allow you to detect
  683.            numbers which belong to other BBS' and should not be
  684.            validated.
  685.  
  686.       SFCB.LD
  687.            If Log LD Calls is utilized, then any long distance calls
  688.            will be logged to this file.  You may then compare this log
  689.            file with your phone bill to quickly determine which calls
  690.            were from the BBS for validation purposes.
  691.  
  692.       Display Files
  693.  
  694.            Display files in SFCB follow the Spitfire convention.  Mono
  695.       files (without colouring) have .BBS extensions and coloured
  696.       (ANSI) files have .CLR extensions.  Most of the standard SF codes
  697.  
  698.  
  699.  
  700.                                                                 Page 13
  701.                    SFCB [Spitfire Call-Back] Documentation
  702.  
  703.       are supported.  They include: user name, security, phone number
  704.       and time left.  You may also name your own display files in the
  705.       [Messages] section of the SFCB.INI file.  Here are the default
  706.       files that can be customized for your copy of SFCB:
  707.  
  708.         Screen Name            Description
  709.  
  710.  
  711.        CBOPEN.BBS/CLR        Opening display - inform user of program
  712.                              purpose
  713.        SETTINGS.BBS/CLR *    Current settings of call-back program
  714.  
  715.        MAINMENU.BBS/CLR      Displayed instead of the default main menu
  716.  
  717.        TERMINAL.BBS/CLR      Displayed instead of the default terminal
  718.                              menu
  719.        CBHELP.BBS/CLR        Printed when the user asks for help.
  720.  
  721.        VERIFY.BBS/CLR        Displayed when caller is found in SFCB.OK
  722.                              (preverified)
  723.  
  724.        TIMEDAY.BBS/CLR       Cannot be validated at this time of day
  725.                              (local and long distance callers)
  726.        NUMNOVAL.BBS/CLR      Telephone number cannot be used for
  727.                              validation (SFCB.BAD)
  728.  
  729.        NODUPES.BBS/CLR       Telephone number is a duplicate (found in
  730.                              SFUSERS.DAT)
  731.  
  732.        NOQUALFY.BBS/CLR      Shown when a user is not qualified by reason
  733.                              of: duplicates, time of day, long distance,
  734.                              not enough time, wrong security level...
  735.        CBNOLD.BBS/CLR        Shown if a user is a long distance caller,
  736.                              and long distance validation is disabled.
  737.  
  738.        CONNECT.BBS/CLR       Displayed prior before returning to BBS
  739.       * In the absence of SETTINGS.BBS/CLR the valid times, and number
  740.       of attempts will be shown.
  741.       In most cases, if there is no file available, a default line will
  742.       be displayed from the [Messages] section of SFCB.INI
  743.  
  744.  
  745.  
  746.  
  747.                                                                 Page 14
  748.                    SFCB [Spitfire Call-Back] Documentation
  749.  
  750.       ▄──────────────────────────▄
  751.       │        EXECUTION         │
  752.       ▀══──────────────────────══▀
  753.  
  754.            In the event that there are problems with the successful
  755.       installation of the SFCB program, please refer to the comments
  756.       shown to you on the screen and in the log file (SFCB.LOG)  You
  757.       will be informed if SFCB cannot find the door data file or if it
  758.       has not been installed properly.  When all goes well, you will
  759.       see the initial log-on screen (CBOPEN.BBS), then the program
  760.       'plug', stating the current version and registration information;
  761.       the usual stuff.
  762.  
  763.            The initial log-on screen should contain the necessary
  764.       information to introduce the purpose of the program to the user
  765.       and the process that it involves.  (For example, use the
  766.       CBOPEN.BBS/CLR)  ANSI.SYS does not have to be loaded to see ANSI
  767.       correctly on the BBS computer while within SFCB.
  768.            The main menu will look something like this:
  769.  
  770.       Current settings:
  771.           3 call-back attempts will be made.
  772.           Long distance validation NOT enabled
  773.  
  774.           ( Time of day )   1 1 1 1 1 1 1 1 1 1 2 2 2 2
  775.         0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3
  776.         ************************************************  Local call back times
  777.                                             ^
  778.         "*" denotes valid times to call-back, "^" denotes current time slot.
  779.         ╒═════════════════════════[ SFCB Main Menu ]══════════════════════════╕
  780.         │ [P] Phone Number:     519-455-4880  [A] Ansi Toggle:      Off       │
  781.         │ [T] Terminal Program: Local         [V] View Settings               │
  782.         │ [C] Begin Call-Back   Ready         [H] Help                        │
  783.         │ [@] About SFCB                                                      │
  784.         │ [Q] Quit to BBS                     [G] Goodbye (Hang up)           │
  785.         ╘═════════════════════════════════════════════════════════════════════╛
  786.         It is presently  6:00 p.m. on Mon., Apr.  5, 1993.
  787.         You have been on 2 minutes with 58 remaining.
  788.         Main Menu - [P A T V C H @ Q G]
  789.  
  790.            The menu shows the user's phone number and terminal program
  791.       (which must be selected)  When all is ready, option "C"
  792.       (call-back) is activated and the user can continue call-back.  If
  793.       the terminal program is not selected, it will be prompted before
  794.       call-back can continue.
  795.            SFCB will attempt to determine whether the caller is long
  796.       distance from the BBS.  Numbers that are not in the same area
  797.       code are assumed to be long distance and will not be validated
  798.       unless the sysop allows long distance validation.  If a number is
  799.       within the BBS' area code, but not considered a local exchange
  800.       (by comparing it to the numbers in the SFCB.XCH file or
  801.       [LocalExchanges] section of SFCB.INI),  SFCB will ask if the
  802.       user's number is long distance.  If the number is not local and
  803.  
  804.  
  805.  
  806.                                                                 Page 15
  807.                    SFCB [Spitfire Call-Back] Documentation
  808.  
  809.       the user informs SFCB that it is, no validation will be made, nor
  810.       will a long distance charge be incurred.  If the number is local
  811.       and not found in the data files as a local exchange, the log file
  812.       will show the number so you can then add it to your files as a
  813.       local number.
  814.            After checking security levels, phone numbers and call-back
  815.       time restraints, SFCB hangs up and attempts to call the user
  816.       back.  If you cannot dial with touch-tone, make sure you set the
  817.       Tone available option to False instead of True for touch-tone
  818.       dialing.  If you specify an InitString code in SFCB.INI, it will
  819.       be sent to the modem before the first call-back attempt.  This
  820.       init string need only contain settings specific to the call back.
  821.       For most systems, this will only be something similar to:
  822.       ATS0=0S11=40  This will set a fast tone speed and turn off any
  823.       auto answering.  If an incoming call is detected before the
  824.       subsequent dial attempt, SFCB will answer the call, send the
  825.       InProgress message in the [Messages] section and hang up.  Also
  826.       of note, you should disable any TSR's which detect rings and
  827.       reboot your computer before you run SFCB.  You may re-enable it
  828.       after SFCB is completed (for example, in the batch file.)  After
  829.       the connection with the original caller is re-established, (and
  830.       CONNECT.BBS/CLR displayed) the user will be prompted for his or
  831.       her name and password.  You may force the user to enter his/her
  832.       birth date as well, and/or a random code (which is displayed
  833.       prior to hangup).  When all is entered correct (case is NOT
  834.       significant for the password entered) then the final file,
  835.       CBCLOSE.BBS/CLR will be displayed, explaining what the new
  836.       security level entails, or whatever else the user must do for
  837.       complete validation, etc., depending on your BBS setup.
  838.            You will be able to monitor at all times where the user is
  839.       currently at in the program.  Also displayed on the top portion
  840.       of the screen is the user name, baud rate, security level and
  841.       time left.  Press F1 or Home to display the available function
  842.       keys.  At times, text such as [Password] will appear in the top
  843.       left of the screen which may aid you in testing and operating
  844.       SFCB.
  845.            Once a user is in the program, you may chat by pressing
  846.       ALT-C.  Pressing ALT-C again will to exit the chat.  Likewise,
  847.       you may shell to DOS if need be by pressing ALT-J (provided that
  848.       you have enough memory available).  To exit back to SFCB after a
  849.       drop to DOS, type "EXIT".
  850.  
  851.            SFCB will provide users with sysop level or greater an
  852.       additional menu, which can be used to display the log and
  853.       validation files. (SFCB.LOG, SFCB.VAL, SFCB.NVL)  You will be
  854.       prompted for a password.  Enter your own password, capitalizing
  855.       the first letter of each word.
  856.  
  857.  
  858.       ▄──────────────────────────▄
  859.       │      FUNCTION KEYS       │
  860.       ▀══──────────────────────══▀
  861.  
  862.  
  863.  
  864.                                                                 Page 16
  865.                    SFCB [Spitfire Call-Back] Documentation
  866.  
  867.            Here is a list of keys available to the sysop while a caller
  868.       is on-line.  (They cannot be used by the caller.)  Press F1 or
  869.       HOME to display these keys while running the program.
  870.  
  871.       Chat mode           Alt C     Press Alt C to end chat.
  872.       Drop to DOS         Alt D, Alt J   Local drop to dos only.  Type
  873.                                     EXIT to return to SFCB
  874.       Change Security     F2        Change the security level of the
  875.                                     user manually.
  876.       Zoom/Unzoom         F5        Switch between full screen and
  877.                                     divided screen modes.
  878.       Subtract time       F6        Subtract 5 minutes.
  879.       Add time            F7        Adds 5 minutes to user's time.
  880.       Twit user           Alt F2    No sysop can be without a user
  881.                                     terminate function. :)  Twit will
  882.                                     hang up the modem line and
  883.                                     disconnect the caller, or end a
  884.                                     local mode test.
  885.  
  886.  
  887.       ▄──────────────────────────▄
  888.       │        WARNINGS          │
  889.       ▀══──────────────────────══▀
  890.  
  891.            Due to the nature of software and hardware, 100%
  892.       compatibility is a goal but hardly a reality.  This program has
  893.       been tested on a number of different computer systems, but this
  894.       cannot guarantee that it will work with any specific (or your)
  895.       setup and software/hardware combination.
  896.  
  897.            RainbowSoft Wares will be more than happy to provide
  898.       assistance and fix errors.  Please let us know!  If you have any
  899.       suggestions for improvement, or bug reports please feel free to
  900.       report them.  (Refer to the locations noted at the beginning of
  901.       the document.)
  902.  
  903.  
  904.       ▄──────────────────────────▄
  905.       │       DISCLAIMER         │
  906.       ▀══──────────────────────══▀
  907.  
  908.            SFCB is distributed AS IS.  Neither Richard Sleegers, nor
  909.       RainbowSoft Wares will be held responsible for direct or indirect
  910.       damage to your computer (or its peripherals) or to your sanity.
  911.       There are no warranties, expressed or implied, as to the
  912.       operation or functionality of this program.
  913.            The primary goal of shareware is to provide quality programs
  914.       at a low price to the purchaser.  If the program does not work
  915.       for you, you  are not obligated to use it!  On the other hand, if
  916.       it saves you time, and you leave it installed on your system, you
  917.       should feel obligated to register it. Read on.
  918.  
  919.  
  920.  
  921.                                                                 Page 17
  922.                    SFCB [Spitfire Call-Back] Documentation
  923.  
  924.       ▄──────────────────────────▄
  925.       │  SHAREWARE INFORMATION   │
  926.       ▀══──────────────────────══▀
  927.  
  928.             SFCB is a Shareware program, distributed under the 'Try
  929.       Before You Buy' concept; this means that after you have tried the
  930.       program for a 'reasonable' length of time, (28 days) you must
  931.       either register the program, or remove it from your system.
  932.             Registering this program grants you a limited license to
  933.       use, for your personal use only on your BBS, all files and
  934.       documents contained in the original software package, distributed
  935.       by RainbowSoft Wares.
  936.            Please see the file, SFCB.REG, for more information on
  937.       registering this version of SFCB and what benefits arise from
  938.       registering.
  939.  
  940.       You are granted a limited license to distribute SFCB, subject to
  941.       the following conditions:
  942.  
  943.       1.   You may not receive any financial compensation for direct
  944.            access to this program.  One exception is noted, whereby you
  945.            may recover costs of medium (Disk(ette)s, or other
  946.            electronic medium) only, at a reasonable amount.
  947.       2.   You may not alter any documents, programs, or files
  948.            distributed with SFCB.
  949.       3.   You may not mass-distribute (on CD-Rom; bundled disks/tapes)
  950.            copies of SFCB without the written permission of Richard
  951.            Sleegers/RainbowSoft Wares.  Distribution by electronic mail
  952.            systems (or Bulletin Board Systems) is permitted just in
  953.            case condition 1 is met.
  954.  
  955.  
  956.       ▄──────────────────────────▄
  957.       │         SUPPORT          │
  958.       ▀══──────────────────────══▀
  959.  
  960.       Registered or not, you may obtain help via postal mail or e-mail
  961.       (via modem)  To send registrations and comments, use the
  962.       following address:
  963.  
  964.                               RainbowSoft Wares
  965.                              C/O Richard Sleegers
  966.                          R.R. #8 (1697 Hamilton Road)
  967.                            London, Ontario, CANADA
  968.                                    N6A 4C3
  969.  
  970.       To reach me via modem (Richard Sleegers) send e-mail to the sysop
  971.       at:
  972.  
  973.                           Rainbow BBS  (519)455-4880
  974.                            Sysop: Richard Sleegers
  975.                 1200-14400 Baud (USRobotics V.32 bis/V.43bis)
  976.  
  977.  
  978.  
  979.                                                                 Page 18
  980.                    SFCB [Spitfire Call-Back] Documentation
  981.  
  982.                            CircuitNet Node: 519002
  983.  
  984.  
  985.            If you have questions pertaining to SPITFIRE you may address
  986.       them to Mike Woltz at:
  987.  
  988.                              Spitfire Support BBS
  989.                          Buffalo Creek - 515-225-8496
  990.                            12/24/96/16800 Baud HST
  991.  
  992.  
  993.       ▄──────────────────────────▄
  994.       │  TRADEMARKS, COPYRIGHTS  │
  995.       ▀══──────────────────────══▀
  996.  
  997.            All SFCB executables and documentation are copyright (c)
  998.       1991-1993 by Richard Sleegers and RainbowSoft Wares.
  999.  
  1000.            SPITFIRE is a registered trademark of Buffalo Creek Software.
  1001.               SPITFIRE is copyrighted 1986-1993 by Mike Woltz.
  1002.  
  1003.               Turbo Pascal is a registered trademark of Borland International, Inc.
  1004.               Turbo Pascal is copyrighted 1983-1993 by Borland International, Inc.
  1005.  
  1006.               Portions of this program use source code provided by Mike Woltz and
  1007.         Buffalo Creek Software to allow file sharing.  BCSHARE may be downloaded from
  1008.         the BCS Bulletin Board at 515-225-8496
  1009.  
  1010.               Portions of this program are written with Object Professional and Async
  1011.         Professional under license from TurboPower Software.
  1012.  
  1013.               LzEXE is copyright 1989 Fabrice BELLARD.
  1014.               PkLite (tm) is copyright 1993 PKWARE Inc.
  1015.               DesqView is copyright/trademark of Quarterdeck Systems.
  1016.  
  1017.               Any other products mentioned are trademarks and or copyright of their
  1018.         respective owners.
  1019.  
  1020.  
  1021.       ▄──────────────────────────▄
  1022.       │    SFCB HALL OF FAME!    │
  1023.       ▀══──────────────────────══▀
  1024.  
  1025.            This section is dedicated to all those who helped in the
  1026.       production of SFCB.
  1027.  
  1028.            Thanks to all of the new users of RAINBOW BBS who have put
  1029.       up with me while I tried different (read unworkable) versions,
  1030.       usually made for different BBS's; or just plain had to WAIT while
  1031.       I worked on this program!
  1032.  
  1033.            Thanks to Tim Ingram of the Radio Station BBS who helped
  1034.  
  1035.  
  1036.  
  1037.                                                                 Page 19
  1038.                    SFCB [Spitfire Call-Back] Documentation
  1039.  
  1040.       Beta test the original version and provided valuable suggestions
  1041.       and advice.  A golden globe goes to Bill Arlofski of the Reverse
  1042.       Polarity BBS for numerous suggestions prior to the release of
  1043.       version 1.2, and for testing on high speed modems.  Likewise,
  1044.       Derek Motloch of The Computer Room (TCR) who provided bug reports
  1045.       and suggestions, plus an HST modem to test the high-speed
  1046.       routines as well.  (Until I got my own high speed modem!)  Thanks
  1047.       to Jose Frias as well for helping me hammer out a problem with
  1048.       his local phone system.
  1049.  
  1050.  
  1051.       ▄──────────────────────────▄
  1052.       │   FUTURE MODIFICATIONS   │
  1053.       ▀══──────────────────────══▀
  1054.  
  1055.            SFCB is always changing, as suggestions are made and new
  1056.       ideas put into place.  This version reflects changes to long
  1057.       distance validation, area codes, the addition of a number of
  1058.       configurable display files, tightening the loophole with the
  1059.       duplicate phone number scan and some minor bug fixes.  I am open
  1060.       to other suggestions which you may have to improve or enhance
  1061.       SFCB.  You can contact me by mail or through Rainbow BBS.  See
  1062.       the previous Support section for details.
  1063.            Some features I am working on:
  1064.       ■ Inserting messages into the message area to welcome new users.
  1065.       ■ More advanced detection of local/toll/long distance calls.
  1066.       ■ Message queue and last message pointer configuration.
  1067.       ■ Overseas phone number support.
  1068.       ■ Caller ID support.  (Hopefully using existing modems)
  1069.       ■ Safe mode - to prevent excessive re-tries spanning calls.
  1070.  
  1071.  
  1072.       ▄──────────────────────────▄
  1073.       │   MODIFICATION HISTORY   │
  1074.       ▀══──────────────────────══▀
  1075.  
  1076.            For changes to this version and prior versions of SFCB,
  1077.       please refer to the file SFCB.NEW.
  1078.  
  1079.  
  1080.       ▄──────────────────────────▄
  1081.       │   QUESTIONS AND ANSWERS  │
  1082.       ▀══──────────────────────══▀
  1083.  
  1084.       Question: What happens if a BBS system is called through SFCB?
  1085.       Answer:   The user will NOT be validated.  SFCB will never
  1086.            receive the user's name or password.  In your log file, you
  1087.            will notice some strange responses to the prompt for the
  1088.            user's name, and might be able to see what BBS system was
  1089.            called.  To prevent local Bulletin Boards from being called,
  1090.            lock out the numbers via the SFCB.BAD file or
  1091.            [DoNotValidate] section of SFCB.INI.  If you choose to use
  1092.  
  1093.  
  1094.  
  1095.                                                                 Page 20
  1096.                    SFCB [Spitfire Call-Back] Documentation
  1097.  
  1098.            the Log Reconnect option, then all incoming data is logged
  1099.            to a SFCB.RCT file.  This will allow you to examine which
  1100.            numbers are actually other BBS systems.
  1101.  
  1102.       Question: What exactly does SFCB modify?
  1103.       Answer:   SFCB will modify the SFDOORS.DAT file (or SFMAIN.DAT,
  1104.            whichever file it finds)  which is then re-read by SPITFIRE
  1105.            on return from the door.  If you are using a version of
  1106.            Spitfire older than 3.0 or are using the subscription option
  1107.            in SFCB 1.3, the SFUSERS.DAT file is modified.  The
  1108.            subscription option will not work as a menu extension or
  1109.            from the  SFSECxx.BAT file.
  1110.  
  1111.       Question: What version of SPITFIRE does SFCB 1.3 work with?
  1112.       Answer:   SFCB is backwards compatible with version 2.8 and has
  1113.            been revised to work with version 3.3 on multitasking
  1114.            systems, with file sharing routines (Courtesy of BCS and
  1115.            Mike Woltz through the use of BCShare)
  1116.  
  1117.       Question: Why does SFCB ask for the user's name and password upon
  1118.            re-connection?
  1119.       Answer:   The answer to this question is obvious.  A user could
  1120.            leave the number of another Bulletin Board and be validated
  1121.            when it connects. Entering the name and password ensures
  1122.            that it is the same person that initiated the call-back.
  1123.  
  1124.       Question: Should I copy my SFDOORS.DAT file to the SFCB directory
  1125.            before calling SFCB?
  1126.       Answer:   In a word, NO!  Some software may suggest this, but
  1127.            whether you are running a single node or multi node BBS, you
  1128.            should use the -D option to point to the location of the
  1129.            SFDOORS.DAT or SFMAIN.DAT file.  Copying the file may be
  1130.            useful if you wish to have a copy around to examine, since
  1131.            Spitfire deletes it once it has been re-read and processed.
  1132.  
  1133.       Question: How to I get support?
  1134.       Answer:   You can call Rainbow BBS or write by mail (see Support
  1135.            section for details)  If you wish to pre-validate your
  1136.            account on Rainbow BBS, please include your number and
  1137.            unique password to use on Rainbow BBS with the registration
  1138.            form.  (Use SFCBINST.EXE to print out your registration
  1139.            form.)
  1140.  
  1141.       Question: I am having timeout problems with the call-back.  The
  1142.            modem will dial out but will not send a CONNECT or NO
  1143.            CARRIER signal to the modem, and then SFCB dials out again
  1144.            but immediately sends out a NO CARRIER.  This sometimes
  1145.            happens more than once.
  1146.       Answer:   You should change the contents of your modem's S7
  1147.            register (on Hayes compatible modems)  This register
  1148.            controls the modem's internal wait time for reconnection.
  1149.            SFCB is set for a dial timeout of 60 seconds, so if your S7
  1150.  
  1151.  
  1152.  
  1153.                                                                 Page 21
  1154.                    SFCB [Spitfire Call-Back] Documentation
  1155.  
  1156.            register is greater than 60 seconds, it will time out before
  1157.            the modem.  Change your register by using the ATS7=45
  1158.            command (to set it to 45 seconds for example)
  1159.            Alternatively, you can store it in your NRAM (if one is
  1160.            available)  If your modem does not have an NVRAM storage
  1161.            area, place the S7=45 in your modem initialization string.
  1162.            (In SPITFIRE, use the Alt-M command, option <I> at the ready
  1163.            for user prompt.  You may have to tweak this timeout with
  1164.            the SFCBINST program until you have a working program.  I
  1165.            suggest register S7 set to between 30 and 45, and timeout at
  1166.            60.  NO CARRIER or BUSY will break the timeout, so it will
  1167.            not necessarily wait 60 seconds between each dial attempt.
  1168.  
  1169.       Question: My modem will not properly hang up before calling the
  1170.            user back.  What am I doing wrong?
  1171.       Answer:   One possible problem is the setting of your &D on your
  1172.            modem.  You must have an &D1 or &D2 setting (&D1 is
  1173.            preferred, which tells the modem to follow carrier) or the
  1174.            modem may not hang up properly.  An &D3 setting is known to
  1175.            totally baffle the call-back property.  SFCB attempts to
  1176.            hang up by resetting the DTR (data terminal ready)  If this
  1177.            cannot be done, the it must attempt to put the modem in
  1178.            terminal mode by sending an escape code.  An S2=1 setting is
  1179.            crucial here (the SF standard)  If you use a different S2
  1180.            setting (escape code)  place S2=1 in the InitString option
  1181.            in the [Modem] section of SFCB.INI.  If these are correct
  1182.            and hanging up is still a problem, then SFCB might not be
  1183.            able to work properly with your type of modem.
  1184.  
  1185.       Question: I sometimes get strange error messages from the modem
  1186.            when SFCB is trying to dial out.
  1187.       Answer:   This usually indicates a problem with your modem setup.
  1188.            If SPITFIRE works fine when callers use your system, then
  1189.            use the Initialization section in [Modem] or with the
  1190.            SFCBINST program to modify the following modem parameters
  1191.            (using the HAYES modem set)
  1192.            E0   Echo modem commands is OFF
  1193.            Q0   The modem is set to send responses
  1194.            V1   The modem echoes Word reponses, not Digit responses.
  1195.            S2=1 The escape character must be ASCII value 01 (Ctrl-A) if
  1196.            you do not use DTR to reset the modem
  1197.            &C1  Follow carrier detect of the remote carrier signal.
  1198.            &D2  If you use DTR to disconnect callers, your modem should
  1199.            reset when the Data Terminal Ready signal is turned off.
  1200.  
  1201.       Question: When testing SFCB my modem responds NO CARRIER before I
  1202.            can complete typing in ATA.  Does my modem use a different
  1203.            answer command?
  1204.       Answer:   Not likely.  Some modems are strict about key presses
  1205.            while detecting carrier (after the RING code comes in)
  1206.            However, most modems in this category will work properly if
  1207.            you press a key (ENTER for example), causing the NO CARRIER
  1208.  
  1209.  
  1210.  
  1211.                                                                 Page 22
  1212.                    SFCB [Spitfire Call-Back] Documentation
  1213.  
  1214.            response, and then typing ATA.  Since the calling computer
  1215.            has not yet hung up the line, a connection is established.
  1216.            However, to make it simpler for your average user, use the
  1217.            [Terminals] section to tailor responses to individual
  1218.            terminal programs.  For example, Telix uses Alt-O, A to send
  1219.            the auto-answer string.  So you could tell your Telix users
  1220.            to press that sequence after hang up and before being called
  1221.            back.  (They should also be told how to disable auto-answer,
  1222.            if their phone line is also used for voice!)
  1223.  
  1224.       Question: Version 1.2 used to work fine on my system and now 1.3
  1225.            causes lockups or other problems.
  1226.       Answer:   SFCB now uses detection schemes to determine whether to
  1227.            use Desqview or Fossil services.  The default toggle is now
  1228.            NOT to check, but you have have previously enable the
  1229.            command line switch (-X), then remove that switch.
  1230.  
  1231.  
  1232.       ▄──────────────────────────▄
  1233.       │    OTHER RSW PRODUCTS    │
  1234.       ▀══──────────────────────══▀
  1235.  
  1236.       (Available from Rainbow BBS and other fine Spitfire BBS')
  1237.  
  1238.       SFBANGA   Spitfire banking/gambling program.  Allows users to
  1239.                 bank time for future usage.  They can gamble away their
  1240.                 time as well.  Banked time can gain interest at a sysop
  1241.                 definable rate.
  1242.       SFMAINT   Spitfire file area maintenance program.  Creates
  1243.                 downloadable file listings, file area statistics,
  1244.                 supports multiple line descriptions.  Supports adding,
  1245.                 deleting, modifying, moving files from the BBS file
  1246.                 areas.  Other features include off-line files and GIF
  1247.                 descriptions.
  1248.       SFQUEST   Spitfire questionnaire series.  Compatible with
  1249.                 Spitfire questionnaires, this program improves upon
  1250.                 them by adding multiple support questions, analysis of
  1251.                 answer files, DOS errorlevel support for use with menu
  1252.                 systems, and can call other programs and read their
  1253.                 errorlevel results, so other non communications
  1254.                 programs can be used to greater flexibility.  Nested
  1255.                 IF/THEN statements are supported as well as being able
  1256.                 to call other questionnaires from within another.
  1257.       FDS       File Database System.  Collate file listings from other
  1258.                 BBS' (Spitfire, Wildcat and PcBoard file listings
  1259.                 supported)  Allow users to search on-line by file name
  1260.                 or description for a file on any BBS in the database.
  1261.  
  1262.  
  1263.  
  1264.                                                                 Page 23
  1265.                    SFCB [Spitfire Call-Back] Documentation
  1266.  
  1267.       ▄──────────────────────────▄
  1268.       │      Quick Index         │
  1269.       ▀══──────────────────────══▀
  1270.  
  1271.       ANSI  10, 12, 14
  1272.       Caller ID  19
  1273.       DESQVIEW  7, 18, 22
  1274.       duplicate  8-10, 13, 19
  1275.       FOSSIL  7, 22
  1276.       INSTALL  3, 4, 8
  1277.       long distance  3, 5, 7-15, 19
  1278.       Rainbow BBS  17-20, 22
  1279.       SFCB.BAD  9, 10, 13, 19
  1280.       SFCB.INI  6-8, 10, 12-15, 19, 21
  1281.       SFCB.LD  12
  1282.       SFCB.LST  12
  1283.       SFCB.NVL  12, 15
  1284.       SFCB.OK  9, 10, 13
  1285.       SFCB.RCT  12, 20
  1286.       SFCB.TRM  9, 11
  1287.       SFCB.VAL  8, 12, 15
  1288.       SFCB.XCH  8, 9, 11, 14
  1289.       SFCBINST  4-8, 20, 21
  1290.       SFDOORS.DAT  4-6, 20
  1291.       SFMAIN.DAT  4-6, 20
  1292.       Shareware  2, 6, 16, 17
  1293.       wildcards  9
  1294.       [AllowDuplicate]  9
  1295.       [DoNotValidate]  9, 10, 19
  1296.       [Holidays]  6, 9
  1297.       [LocalExchanges]  9, 11, 14
  1298.       [LogFile]  9, 12
  1299.       [Messages]  9, 10, 13, 15
  1300.       [PreValidated]  9, 10
  1301.       [Terminals]  9, 11, 22
  1302.